home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / UTILITY / LZESHE12 / LZESHL21.DOC < prev    next >
Text File  |  1990-03-29  |  11KB  |  217 lines
  1.                                  LZESHELL.EXE
  2.                                  Version 2.10
  3.  
  4.      ┌───────────────────────────────────────────────────────────────────┐
  5.      │  An English language shell program for automating the use of      │
  6.      │  Fabrice Bellard's EXE file compression utilities:  LZEXE for     │
  7.      │  compressing EXE files; UPACKEXE for unpacking EXE files that     │
  8.      │  have been packed with Microsoft's EXEPACK utility; and COMTOEXE  │
  9.      │  for converting COM files to EXE files so they can be compressed. │
  10.      └───────────────────────────────────────────────────────────────────┘
  11.  
  12.      (This version of LZESHELL is very similar to version 2.00 in that it
  13.       integrates three of Bellard's file compression utilities.  However,
  14.       it can also run Kuo's UNLZEXE to decompress files that have been
  15.       compressed with LZEXE.  One obvious use for UNLZEXE is restoring
  16.       a file that failed to run after compression.)
  17.  
  18.  
  19. AUTHOR:  Pete Petrakis, CIS 76555,1175
  20.  
  21.  
  22. DESCRIPTION
  23.  
  24. This program is designed to work only with version 0.91 of LZEXE, a utility
  25. that can compress EXE files substantially while leaving them executable.  The
  26. compressions LZEXE achieves are usually in the range of 30 to 40 percent,
  27. although they are often higher than that.  Programs compressed with LZEXE
  28. decompress themselves when they are run.  The decompression time is negligible.
  29. LZEXE was written by Fabrice Bellard, of Grabels, France and is still under
  30. development.  It is a free program, but Mr. Bellard retains the copyright.
  31.  
  32.   Version 0.91 of LZEXE overcomes version 0.90's problem of excessive load
  33. memory size for compressed files.  The compressed files now take about the same
  34. amount of memory to load as they did before compression.  For this reason my
  35. previous shell program LZEFIX, which ran Microsoft's EXEMOD header utility
  36. to reduce the excessive load sizes created by version 0.90, should not be used
  37. with version 0.91.  It isn't needed.  In fact it could cause problems
  38. (including having to reboot your system) if you try to use it with this newer
  39. version of LZEXE.  Accordingly, LZESHELL makes no adjustment to the headers of
  40. compressed EXE files.
  41.  
  42.   Unlike the previous version of LZEXE, version 0.91 prompts, in French, for
  43. user input, depending on what it finds out about the file you have asked it
  44. to compress.  LZESHELL translates the prompts into English (the translation
  45. is not literal) and feeds your responses to LZEXE.
  46.  
  47.   That's not all it does, however.  LZESHELL version 2.10 automates the use
  48. of three of Bellard's utilities:  LZEXE v0.91, UPACKEXE v1.00; and 
  49. COMTOEXE v1.01.  In addition, it can also run Kuo's UNLZEXE to decompress
  50. files that have been compressed with either version 0.90 or 0.91 of LZEXE.
  51.  
  52.  
  53.  
  54.                                    -1-
  55.   UPACKEXE unpacks EXE files that have been compressed with Microsoft's
  56. EXEPACK utility so LZEXE can do an even better compression job on them.
  57. COMTOEXE converts .COM files to .EXE files so they can be compressed with
  58. LZEXE.  The previous versions of LZESHELL (1.00 and 1.01) were designed to run
  59. LZEXE and UPACKEXE, but not COMTOEXE; that program had to be run separately.
  60. Version 2.10 runs all three automatically.
  61.  
  62.   Version 0.91 of LZEXE can detect files that have been EXEPACKed.  When it
  63. does, it tells you so and asks whether it should continue the compression or
  64. quit so you can run UPACKEXE first.  In that situation, you would normally end
  65. up running two programs manually.  When you use LZESHELL, however, you don't
  66. have to quit if you want to use UPACKEXE.  LZESHELL translates the prompt into
  67. English, and if your response is that you want to unpack the file before
  68. compressing it, it immediately runs UPACKEXE.  Then it runs LZEXE again
  69. to complete the compression.  In other words, you don't go back to DOS until
  70. both programs have been run.
  71.  
  72.   If you run LZEXE alone and tell it to compress a COM file (using the
  73. command:  LZEXE filename.COM), it won't do it.  Instead it will quit, with
  74. advice to convert the file to an EXE first with COMTOEXE.  Again this
  75. means running two programs manually.  If you use LZESHELL, however, the
  76. conversion of the COM file to an EXE file by COMTOEXE proceeds automatically,
  77. followed automatically by compression of the EXE version by LZEXE.
  78.  
  79.   A point to remember about COMTOEXE is that it doesn't take your word that
  80. the file is a COM file, because EXE files sometimes mistakenly get named
  81. COM (such files will still run).  Instead, COMTOEXE checks the file header
  82. to see what kind of executable file it really is.  If it sees the mark of an
  83. EXE file there, it prints a warning and stops.  When you are running it
  84. through LZESHELL, however, the warning causes the falsely named *.COM file to
  85. be renamed *.EXE, and the compression with LZEXE then proceeds automatically.
  86.  
  87.   In summary, the purpose of LZESHELL is to take control of all of these fine
  88. utilities.  You only need to run one program, LZESHELL, and it runs the others
  89. as needed.
  90.  
  91.   Both UPACKEXE and LZEXE save source files as backups, changing their names
  92. to *.OLD.  This can create a problem when you run UPACKEXE then run LZEXE.
  93. The *.OLD backup file saved by UPACKEXE will be replaced by the *.OLD file
  94. saved by LZEXE -- you end up losing the EXEPACKed *.OLD file.  LZESHELL
  95. eliminates this problem by immediately renaming the *.OLD file produced by
  96. UPACKEXE to *.OPK.  This leaves you with two backup files -- one for the
  97. original EXEPACKed file (*.OPK) and one for the unpacked file (*.OLD).  The
  98. third file will be your LZEXE-compressed EXE file.  If the compressed file
  99. works, you can remove both backup files from your disk.  Otherwise, you can
  100. erase the compressed EXE file and rename one of the backups to *.EXE (probably
  101. the EXEPACKed one, *.OPK, since it's the original and it's smaller).
  102.  
  103.   LZESHELL also generates English prompts for another situation that LZEXE
  104. v.0.91 detects, namely the use of overlays by the EXE file.  Here you are
  105. given the choice of aborting the compression or continuing it (taking the
  106.  
  107.  
  108.                                    -2-
  109. chance that the compressed file won't work).  UPACKEXE v1.00 detects "internal"
  110. overlays (I'm not sure what those are), but in that situation it only issues
  111. a warning and requires no user choices.  LZESHELL translates the warning into
  112. English.
  113.  
  114.   Finally, LZESHELL adjusts the timestamp on derivative files so they are the
  115. same as in the original file.  In contrast, LZEXE, UPACKEXE, and COMTOEXE, when
  116. run by themselves, always give the new file the current date, which some people
  117. feel is a shortcoming since it obliterates a useful identifier.
  118.  
  119.   The features just described are identical to those in LZESHELL version 2.00.
  120. What has been added to the program with version 2.10 is ability to run a
  121. a new program from Japan called UNLZEXE, which decompresses files that have
  122. been compressed by LZEXE (v0.90 or v0.91).  Ability to run that program was
  123. included for just one reason: setting the timestamp of the newly decompressed
  124. file to what it was in its compressed form.  If you run UNLZEXE by itself,
  125. the new file will always get the current date and time.  If you run it through
  126. LZESHELL, however, it gets the same date and time as the source file.
  127.  
  128.  
  129. RUNNING THE PROGRAM
  130.  
  131. LZESHELL, LZEXE (v.0.91), UPACKEXE (v1.00), and COMTOEXE (v.1.01), UNLZEXE
  132. (v. 0.20), or their directories, should be on your system's path (use the DOS
  133. PATH command to do this, preferably in an AUTOEXEC.BAT file).  This will allow
  134. you to move freely from directory to directory to compress or decompress files.
  135. You should always go to the directory of the file you want to process so your
  136. source and derivative files can stay together and receive the same timestamp
  137. as the original.
  138.  
  139. Compressing EXE files:
  140.  
  141.   To compress an EXE file, type the following at the DOS prompt:
  142.  
  143.                   LZESHELL [EXE file to be compressed]
  144.  
  145. Use of the .EXE extension is optional.  If you don't use an extension, LZESHELL
  146. will assume it's an EXE file.
  147.  
  148.  
  149. Compressing COM files:
  150.  
  151.   To compress a COM file, type the following at the DOS prompt:
  152.  
  153.                        LZESHELL [filename.COM]
  154.  
  155. Notice that you have to use the .COM extension on the command line if the
  156. file you want to compress is that type.  That extension acts as a flag that
  157. tells LZESHELL that the first thing it must do is run COMTOEXE to convert
  158. the file to an EXE file before compressing it with LZEXE.  If you don't
  159. use the COM extension, you will get a "file not found" error (unless you
  160. happen to have an EXE file with the same first name).
  161.  
  162.                                    -3-
  163.   As noted, an EXE file that has been erroneously named *.COM will not be
  164. processed by COMTOEXE.  However, the message that COMTOEXE prints in that
  165. situation signals LZESHELL to rename the file to *.EXE, then run LZEXE to
  166. compress it.
  167.  
  168.  
  169. Decompressing EXE files:
  170.  
  171.   To decompress an EXE file that has been compressed with LZEXE, type the
  172. following at the DOS prompt:
  173.  
  174.                       LZESHELL [compressedExefile] /u
  175.  
  176. The /u switch tells LZESHELL to run Kuo's UNLZEXE.  Initally the decompressed
  177. file is named $TmpFil$.EXE and the original compressed file retains its name.
  178. However, LZESHELL renames these files just before quitting.  The original
  179. compressed file gets the extension .OLZ while $TmpFil$.EXE ends up with the
  180. name of the original compressed file.  Both files are given the same date
  181. and time.
  182.  
  183.  
  184. DISPLAYS
  185.  
  186.   Translated warnings and prompts will appear in a box on your screen.  At
  187. the end of the processing a "scorecard" will appear showing you the file
  188. size before and after compression or decompression; the size change in bytes;
  189. and, in the case of compression, the percent reduction.
  190.  
  191.  
  192.  
  193. DISTRIBUTION 
  194.  
  195. LZESHELL may be freely distributed provided it's not modified and no money
  196. is charged for it.  Please be sure this document accompanies it.
  197.  
  198.  
  199. DISCLAIMER 
  200.  
  201. Pete Petrakis accepts no responsibility or liability for any mishap 
  202. resulting from the use of LZESHELL.  To protect yourself against loss of
  203. valuable files you are advised to keep backups in a safe place or check the
  204. performance of processed files thoroughly before discarding their backups.
  205.  
  206.   LZEXE, perhaps its associated programs, and UNLZEXE are still under
  207. development, so there is no assurance that this particular version of LZESHELL
  208. will be compatible with future revisions that might be made.  I will try to
  209. update LZESHELL as needed to maintain compatibility.  Revisions will intially
  210. be made available on the IBMSYS Forum of Compuserve (type GO IBMSYS).
  211.  
  212.                                         Pete Petrakis
  213.                                         1236 River Bay Road
  214.                                         Annapolis, Maryland 21401
  215.  
  216.                                     -4-
  217.